4D Doc Center : Ubicaciones para 4D Chart

4D Chart v13

Ubicaciones para 4D Chart

Puede trabajar con 4D Chart en los siguientes lugares:

Áreas 4D Chart en los formularios,
Ventanas externas 4D Chart,
Áreas fuera de la pantalla 4D Chart.

Esta sección describe cómo crear esas ubicaciones en sus bases de datos.

Áreas 4D Chart en los formularios

Puede colocar 4D Chart en todo formulario. Por lo general, se ubica 4D Chart en un formulario de entrada para que pueda trabajar con documentos. Puede también colocar 4D Chart en un formulario de salida para visualizar e imprimir la información. 4D Chart puede utilizar todo el formulario, o puede compartir el espacio con campos y otros objetos del formulario.

Puede crear áreas de todos los tamaños. Sin embargo, si el tamaño del área es inferior a 300 x 150 píxeles, aparecerá como un botón cuyo título es el nombre de la variable de área. El usuario puede hacer clic en este botón para mostrar el área en modo pantalla completa. Este mecanismo se puede desactivar utilizando el comando CT SET ENTERABLE.

Se utiliza un área objeto activa del tipo Área de plug-in para 4D Chart. Un área de plug-in es uno de los varios tipos de objetos activos en 4D, tales como botones, áreas editables y áreas de desplazamiento. Para obtener más información, consulte la documentación de 4D.

Para referirse a un área 4D Chart en un formulario, utilice el nombre del objeto que utilizó cuando se creó el objeto externo 4D Chart.

Para más información, consulte la sección Hacer referencia a áreas 4D Chart.

Ventanas externas 4D Chart

Utilice la función Open external window para abrir una ventana externa y mostrar un documento 4D Chart vacío. Para más información sobre esta función, consulte el manual Lenguaje de 4D.

Open external window abre una nueva ventana, muestra el área plug-in 4D, soportada por el parámetro areaPlugIn y devuelve el número de identificación del área.

Para 4D Chart, el parámetro areaPlugIn se escribe así: _4D Chart. No omita el guión bajo inicial y el espacio entre "4D" y "Chart". Ambas convenciones son elementos necesarios para la sintaxis.

Open external window crea ventanas modales, permitiéndole tener varias ventanas activas abiertas al mismo tiempo. El comando no espera la entrada del usuario, de manera que puede tener varias ventanas activas abiertas al mismo tiempo. Puede hacer clic entre cada ventana y editar la del frente. Si el tipo de ventana tiene una barra de título, un cuadro menú Control (Windows) o un cuadro de cierre (Macintosh) se añade para permitir que el usuario cierre la ventana.

Para cerrar una ventana externa por programación, pase la variable devuelta por Open external window al comando CLOSE WINDOW.

Ejemplo

El siguiente es un ejemplo del uso de Open external window. Esta instrucción abre una ventana externa y muestra un documento 4D Chart vacío.

vChart:=Open external window(50;50;350;450;8;"Profit Margin Graph";"_4D Chart")

Posteriormente, se utiliza vChart siempre que necesite especificar el área de dicho documento. Por ejemplo:

CT GET DEPTH(vChart;vObject;vHoriz;vVert)

Áreas fuera de pantalla 4D Chart

Un área fuera de la pantalla se almacena en la memoria y no es visible para el programador o para el usuario. Puede utilizar un área fuera de la pantalla para realizar modificaciones a un documento antes de que el usuario lo vea, o para guardar el documento para que el usuario pueda volver al original, si es necesario.

Las operaciones de 4D Chart se puede realizar con mayor rapidez en un área fuera de la pantalla porque la pantalla no tiene que ser rediseñada.

Puede utilizar la función CT New offscreen area para crear un área fuera de la pantalla. Puede utilizar el comando CT PICTURE TO AREA para ubicar un campo de imagen (que puede contener un área 4D Chart) en un área 4D Chart (que puede ser un área fuera de la pantalla). Para una explicación completa de estos comandos, consulte los comandos en el tema Área.

Recuerde que debe eliminar el área fuera de la pantalla después de haberla terminado de utilizar para liberar la memoria que utiliza. 4D mostrará un mensaje de error cuando cierre la base de datos sin borrar todas las áreas fuera de la pantalla.

Ejemplo

Cuando se pone en un método de proyecto, el código en el siguiente ejemplo crea un área fuera de la pantalla para guardar un documento. Utilizando un botón en un formulario, puede permitirle al usuario volver al documento original guardado.

 Area:=CT New offscreen area

 QUERY([Ventas];[Ventas]CustID=vCustID)

 If(Records in selection([Ventas]=1)

    CT PICTURE TO AREA(Area;[Ventas]Profits_)

  `Guardar el gráfico en el área fuera de pantalla

    MODIFY RECORD([Ventas])

  `Modificar el registro de ventas

    CT DELETE OFFSCREEN AREA(Area)

  `Liberar la memoria utilizada por el área fuera de pantalla

 End if

Crea un botón en el formulario de entrada y le asigna el siguiente código:

 Profits:=CT Area to picture(Area;-2)

  `Ubica el área fuera de pantalla que contiene el documento original en el área externa contenida en el formulario

  `Profits.